home *** CD-ROM | disk | FTP | other *** search
/ Aminet 34 / Aminet 34 (2000)(Schatztruhe)[!][Dec 1999].iso / Aminet / dev / moni / HunkFunc.readme < prev    next >
Encoding:
Text File  |  1999-11-06  |  4.2 KB  |  103 lines
  1. Short:    V1.8 display executable file structure
  2. Author:   stoecker@amigaworld.com (Dirk Stoecker)
  3. Uploader: stoecker@amigaworld.com (Dirk Stoecker)
  4. Version:  1.8
  5. Type:     dev/moni
  6.  
  7. This program allows you to display information about the structure of an
  8. Amiga executable file (or a link object). HunkFunc requires OS2.0 for work.
  9.  
  10. The first version of this program is made with help of HunkFunk utility
  11. made by Olaf Barthel. But as Olaf's utility misses a lot of hunks and
  12. other information, I made my own tool. This version knows a lot more
  13. possible configurations and is shorter, as it uses Amiga functions instead
  14. of ANSI-C.
  15.  
  16. Know hunk types are: HUNK_UNIT, HUNK_NAME, HUNK_CODE, HUNK_DATA, HUNK_BSS,
  17. HUNK_RELOC32, HUNK_RELOC16, HUNK_RELOC8, HUNK_EXT, HUNK_SYMBOL,
  18. HUNK_DEBUG, HUNK_END, HUNK_HEADER, HUNK_OVERLAY, HUNK_BREAK,
  19. HUNK_DREL32, HUNK_DREL16, HUNK_DREL8, HUNK_LIB, HUNK_INDEX,
  20. HUNK_RELOC32SHORT, (HUNK_RELRELOC32, HUNK_ABSRELOC16).
  21.  
  22. The File has following argument line:
  23. "FILE/M/A,SREL=SHOWRELOC/S,SSYM=SHOWSYMBOL/S,SEXT=SHOWEXTERN/S,
  24.  SOVT=SHOWOVERLAYTABLE/S,STATS/S".
  25.  
  26. FILE       You must pass at least one file name, but may pass a lot more.
  27.            Patterns are not supported.
  28. SHOWRELOC  displays all reloc entries (there may be really much of them!)
  29. SHOWSYMBOL displays symbol names of HUNK_SYMBOL
  30. SHOWEXTERN displays definitions of HUNK_EXT
  31. SHOWOVERL. display data of overlay table
  32. STATS      show short statistics about file
  33.  
  34. Example output:
  35. File 'C:AddDataTypes':
  36. HUNK_HEADER
  37.   Numhunks =         2 (0 to 1)
  38.   Hunk 000 =      5560 ($0015B8) Bytes
  39.   Hunk 001 =       160 ($0000A0) Bytes
  40.  
  41. HUNK_CODE         5560 ($0015B8) Bytes
  42. HUNK_RELOC32
  43.   Summary            5 entries to hunk 1
  44. HUNK_END
  45.  
  46. HUNK_DATA          160 ($0000A0) Bytes
  47. HUNK_RELOC32
  48.   Summary           14 entries to hunk 0
  49. HUNK_END
  50.  
  51. - First line shows program name.
  52. - HUNK_HEADER is the first hunk of an executable and lists all the hunks.
  53.   There may be additionally comments like CHIP, FAST, ADVISORY or MEMTYPE.
  54. - HUNK_CODE and HUNK_DATA store information.
  55. - HUNK_BSS store memory space, which is filled with 0 on startup.
  56. - HUNK_RELOC32 (and other types) hold relocation information.
  57. - HUNK_END ends an hunk entry.
  58. - In HUNK_CODE, HUNK_DATA and HUNK_BSS the memory flags may be repeated
  59.   in first or second longword. The flags is displayed normally when in
  60.   second longword (size) and preceeded by a '_' (e.g. _CHIP), when in
  61.   first longword (hunk type).
  62. - HUNK_DREL32EXE is in real a HUNK_RELOC32SHORT which uses wrong ID due
  63.   to a bug in OS V37.
  64.  
  65. A lot more information about executable or object file format can be found
  66. in:
  67.  
  68.                 The Amiga Guru Book
  69.                 ©1989,1993 by Ralph Babel
  70.                 Taunusstein 1993
  71.  
  72. If HunkFunc prints a line like "HUNK_??? ($xxxx) - Aborting!", please
  73. contact me and send an example file (if the file is a correct one).
  74.  
  75. Use this tool as you want, but WITHOUT ANY WARRANTY!
  76.  
  77. Contact me at:
  78.  
  79. ************************************************************************
  80. * snail-mail:                  * e-mail:                               *
  81. *   Dirk Stoecker              *   stoecker@amigaworld.com             *
  82. *   Geschwister-Scholl-Str. 10 *   dstoecker@gmx.de                    *
  83. *   01877 Bischofswerda        * world wide web:                       *
  84. *   GERMANY                    *   http://home.pages.de/~Gremlin/      *
  85. * phone:                       * pgp key:                              *
  86. *   GERMANY +49 (0)3594/706666 *   get with finger or from WWW pages   *
  87. ************************************************************************
  88.  
  89.  
  90. ============================= Archive contents =============================
  91.  
  92. Original  Packed Ratio    Date     Time    Name
  93. -------- ------- ----- --------- --------  -------------
  94.     7080    3306 53.3% 29-Oct-99 12:01:36  HunkFunc
  95.     3601    1617 55.0% 29-Oct-99 12:01:58  HunkFunc.readme
  96.    14582    4267 70.7% 29-Oct-99 12:02:00 +HunkFunc.c
  97.     2188     805 63.2% 29-Oct-99 12:02:18 +SDI_ASM_STD_functions.lib
  98.     5632    1977 64.8% 29-Oct-99 12:02:24 +SDI_ASM_STD_protos.h
  99.     3567    1568 56.0% 29-Oct-99 12:02:24 +SDI_defines.h
  100.     1514     517 65.8% 29-Oct-99 12:02:04 +SMakeFile
  101. -------- ------- ----- --------- --------
  102.    38164   14057 63.1% 30-Oct-99 16:58:20   7 files
  103.